home *** CD-ROM | disk | FTP | other *** search
- 25
- --- RECORDSEPARATOR ---
-
- --- RECORDSEPARATOR ---
- ReadRegBinary
- --- RECORDSEPARATOR ---
- Platform:
- --- RECORDSEPARATOR ---
-
- --- RECORDSEPARATOR ---
- Windows
- --- RECORDSEPARATOR ---
-
- --- RECORDSEPARATOR ---
- Description:
- --- RECORDSEPARATOR ---
-
- --- RECORDSEPARATOR ---
- baReadRegBinary gets a binary value from the Windows Registry.
- --- RECORDSEPARATOR ---
-
- --- RECORDSEPARATOR ---
- Usage:
- --- RECORDSEPARATOR ---
-
- --- RECORDSEPARATOR ---
- Result = ReadRegString( KeyName, ValueName, Default, Branch )
- --- RECORDSEPARATOR ---
-
- --- RECORDSEPARATOR ---
- Arguments:
- --- RECORDSEPARATOR ---
-
- --- RECORDSEPARATOR ---
- String, String, String, String.
- --- RECORDSEPARATOR ---
- KeyName is the name of the key.
- --- RECORDSEPARATOR ---
- ValueName is the name of the value. Under 16 bit, this value is ignored.
- --- RECORDSEPARATOR ---
- Default is the string that is returned if the key/value doesn't exist.
- --- RECORDSEPARATOR ---
- Branch is the branch of the registry to use. Can be one of the following:
- --- RECORDSEPARATOR ---
- "HKEY_CLASSES_ROOT"
- --- RECORDSEPARATOR ---
- "HKEY_CURRENT_USER"
- --- RECORDSEPARATOR ---
- "HKEY_LOCAL_MACHINE"
- --- RECORDSEPARATOR ---
- "HKEY_USERS"
- --- RECORDSEPARATOR ---
- ΓÇ£HKEY_CURRENT_USERΓÇ¥
- --- RECORDSEPARATOR ---
- ΓÇ£HKEY_DYN_DATAΓÇ¥
- --- RECORDSEPARATOR ---
- Under 16 bit, only the HKEY_CLASSES_ROOT branch is accessible - the Branch
- --- RECORDSEPARATOR ---
- setting is ignored.
- --- RECORDSEPARATOR ---
-
- --- RECORDSEPARATOR ---
- Returns:
- --- RECORDSEPARATOR ---
-
- --- RECORDSEPARATOR ---
- List (Xtra) or string (UCD).
- --- RECORDSEPARATOR ---
- Returns a list containing the binary value stored in Keyname. If the Keyname
- --- RECORDSEPARATOR ---
- doesn't exist, then the return will be a list containing just the Default value.
- --- RECORDSEPARATOR ---
-
- --- RECORDSEPARATOR ---
- Examples:
- --- RECORDSEPARATOR ---
-
- --- RECORDSEPARATOR ---
- Director:
- --- RECORDSEPARATOR ---
- set data = baReadRegBinary( "Courses\Computers", "Data", "Error",
- --- RECORDSEPARATOR ---
- "HKEY_CLASSES_ROOT" )
- --- RECORDSEPARATOR ---
- Authorware:
- --- RECORDSEPARATOR ---
- data := baReadRegString( "Courses\\Computers", "Data", "Error",
- --- RECORDSEPARATOR ---
- "HKEY_CLASSES_ROOT" )
- --- RECORDSEPARATOR ---
-
- --- RECORDSEPARATOR ---
- Notes
- --- RECORDSEPARATOR ---
- :
- --- RECORDSEPARATOR ---
- In the Xtra, the return will be a list containing the binary values. eg:
- --- RECORDSEPARATOR ---
- [ 23, 45, 68, 0, 3, 5, 0 ]
- --- RECORDSEPARATOR ---
- In the UCD, the return will be a string with each value on a separate line. eg:
- --- RECORDSEPARATOR ---
- "23\r45\r68\r0\r3\r5\r0"
- --- RECORDSEPARATOR ---
- Use the Authorware GetLine function to retrieve the values.
- --- RECORDSEPARATOR ---
- Note that these values will not be the same values as shown in RegEdit - the
- --- RECORDSEPARATOR ---
- values in RegEdit are in hex, while the Xtra returns the decimal equivalents. If the
- --- RECORDSEPARATOR ---
- key does not exist, then a list with the default value (as a string) as its only entry
- --- RECORDSEPARATOR ---
- will be returned, eg:
- --- RECORDSEPARATOR ---
- ["error"]
- --- RECORDSEPARATOR ---
-
- --- RECORDSEPARATOR ---
- See also:
- --- RECORDSEPARATOR ---
-
- --- RECORDSEPARATOR ---
- baWriteRegString
- --- RECORDSEPARATOR ---
- baReadRegNumber
- --- RECORDSEPARATOR ---
- baWriteRegNumber
- --- RECORDSEPARATOR ---
- baDeleteReg